home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / x11 / strategy / xpuzzles.3 / xpuzzles / xpuzzles-5.3.1 / xmball / README < prev    next >
Text File  |  1996-04-08  |  8KB  |  193 lines
  1.     X-BASED MASTERBALL(tm)
  2.     ==================    Masterball X widget, V5.3
  3.  
  4.  
  5.     It has been tested on the following platforms:
  6.  
  7.     HP 3xx & 700        HP-UX 9.0x    X11R5
  8.     Sun4, SPARC        SunOS 4.1.3    X11R4
  9.     Sun4, SPARC        SunOS 5.4    X11R5
  10.     PC, 486            Linux 1.0.9    X11R5(*)
  11.     PC, 486            Linux 1.2.8    X11R6(**)
  12.  
  13.     *    Keypad 5 key may not work, in which case, try it with the
  14.     Num-Lock on
  15.     **    Keypad may not work, since various keycodes may not be defined
  16.     by default.  Check that "KP_1 - KP_9, Home, Up, Prior, Left,
  17.     Begin, Right, End, Down, Next" are defined towards the end of
  18.     /usr/lib/X11/etc/xmodmap.std .  If not defined
  19.     cp /usr/lib/X11/etc/xmodmap.std /usr/lib/X11/xinit/.Xmodmap
  20.     and then motify this or create your own at ${HOME}/.Xmodmap .
  21.     You should just have to uncomment them (get rid of some '!').
  22.     This should be done before X is started.
  23.  
  24.     If yours is not in this list, please let me know -- thanks. The
  25.     most updated source could be found on ftp.x.org under
  26.     /contrib/games/puzzles.
  27.  
  28. HOW TO BUILD?
  29.  
  30.     Do you have Motif?  If so, uncomment line 28 of Imakefile.
  31.  
  32.     It should be easy. Edit the Imakefile (or Makefile.std, see below)
  33.     for appropriate settings of variable SCOREFILE, then do:
  34.     xmkmf
  35.     make
  36.     xmball  [motif version will be xmmball]
  37.  
  38.     Note: if you don't have 'xmkmf' or the "Makefile" it generates
  39.     doesn't work well, edit Makefile.std for appropriate settings for
  40.     XINCLUDEPATH and XLIBPATH, then try:
  41.     make -f Makefile.std
  42.     xmball
  43.  
  44.     or if you have Motif, uncomment appropriate sections, then try:
  45.     make -f Makefile.std all.xm
  46.     xmmball
  47.  
  48.     You should have Mball.ad copied to $(HOME)/Mball or 
  49.     /usr/lib/X11/app-defaults/Mball to run, especially if the background
  50.     is similar to one of the wedges. Edit this file for your preferences.
  51.     You might want to move xmball into /usr/bin/X11 (or wherever your
  52.     X binaries are).
  53.     You might also want to move xmball.man to /usr/man/man6/xmball.6
  54.  
  55. ANYTHING SPECIAL IN USING?
  56.  
  57.     Click on the left mouse button to move a sector.  Release it on an
  58.       another piece and the puzzle will turn towards where the mouse
  59.       button is released.  Usually, a click and release on the same wedge
  60.       is ambiguous and the puzzle will not turn.
  61.     Click on the middle mouse button toggle the practice mode. (This is
  62.       good for learning moves).  Also 'P' or 'p' does the same thing.
  63.       One must double click on the middle mouse button if the puzzle is
  64.       being worked on.
  65.     Click on the right mouse button if you want to randomize the puzzle.
  66.       Also 'R' or 'r' does the same thing.  One must double click on
  67.       the right mouse button if the puzzle is being worked on.
  68.     'I' or 'i' to increase or move up the number of latitude cuts.
  69.     'D' or 'd' to decrease or move down the number of latitude cuts.
  70.     'O' or 'o' to toggle orient mode.
  71.     '2', '4', '6', or '8' (not the keypad 2, 4, 6, 8) to change to 2, 4,
  72.       6, or 8 wedges, respectively.
  73.       Note: if there were odd number of wedges, there would be no 180
  74.       degree turn and therefore the puzzle would be inoperable.
  75.     'S' or 's' to auto-solve.  Unfortunately, its unimplemented.
  76.     'U' or 'u' to undo last move.
  77.     'G' or 'g' to get a saved puzzle.
  78.     'W' or 'w' to write or save a puzzle.
  79.     'Q', 'q', or Control-C to kill program.
  80.  
  81.     Key pad is defined for masterball as:
  82.         /
  83.  
  84.     7   8   9
  85.         ^
  86.     4 < 5 > 6
  87.         v
  88.     1   2   3
  89.  
  90.     The key pad along with the use of the mouse will allow you to move the
  91.     wedges i.e.,
  92.                       KP_DIVIDE=>CCW
  93.     KP_7=>TopLeft     KP_8=>Top       KP_9=>TopRight
  94.     KP_4=>Left        KP_5=>CW        KP_6=>Right
  95.     KP_1=>BottomLeft  KP_2=>Bottom    KP_3=>BottomRight
  96.  
  97.     The control feature allows you to move the whole masterball at
  98.     once without being entered as a move.  Hold down the control key
  99.     while using the left mouse button or the keypad.
  100.  
  101.     One has to orient the wedges in orient mode, besides getting all the
  102.     wedges to be the same color. To do this one has to get the wedges
  103.     with the numbers on one side and in order (clockwise).  This will add
  104.     complexity, so there are 2 sets of records.
  105.  
  106.     Try resizing the masterball. Notice the puzzle resizes to take
  107.     advantage of the "room" available.
  108.  
  109.     The title is in the following format (non-motif version):
  110.     xmball.{2|4|6|8}: <int> @ (<Number of moves>/\
  111.         {<Record number of moves>|NEVER|PRACTICE}) - <Comment>
  112.     {2|4|6|8}: current number of wedges.
  113.     <int>: number of sectors per wedge.
  114.     {<Record...}: puzzle is either in practice mode or record mode
  115.        In record mode, if there is no record of the current puzzle, it
  116.        displays "NEVER".
  117.  
  118.     If you were looking for a auto-solver, sorry. One of the problems in
  119.     auto-solvers the generally don't work for different number of cuts.
  120.     If you know of one let me know.
  121.  
  122.     I know the look is not exactly right.  For simplicity, I did not take
  123.     into account spherical placement of the latitude cuts.
  124.  
  125.     Refer to the man page for detailed command line options.
  126.  
  127.     If you want further information on puzzles, I'll be glad :-) to send
  128.     it to you.
  129.  
  130. SAVE FORMAT
  131.  
  132.     The format is not standard.  The reason is that this is simple to
  133.     produce and the standard notation is no good for variable number of
  134.     wedges.  The format will probably change to become more readable.
  135.  
  136.     wedges: 1-8 number of wedges around ball
  137.     rings: 1-MAXINT number of slices around ball
  138.     orient: 0 false, 1 true  numbers on to be oriented and ordered
  139.     practice: 0 false, 1 true
  140.     moves: 0-MAXINT
  141.  
  142.     startingPosition:
  143.  
  144.         0            Y
  145.      7     1      D     B
  146.                              if orient mode, orientation number
  147.     6       2    C       R     follows face number, clockwise numbered
  148.  
  149.      5     3      O     M
  150.         4            G
  151.  
  152.     This is then followed by the moves
  153.     move #: wedge ring direction control
  154.       each turn is with respect to a sector face.  The first 2 numbers
  155.       (after the ':') wedge, ring, refer to the wedge and level,
  156.       followed by direction and control
  157.     Direction is represented as 0 up, 1 right, 2 down, 3 left, 4 upper right,
  158.       5 lower right, 6 lower left, 7 upper left, 9 clockwise, and 15
  159.       counterclockwise.
  160.     Control is represented as 0 or 1, 1 if the whole ball is moved at
  161.       once, 0 if not.  The xmball record keeper does not count a control
  162.       move as a move, but here we do.
  163.  
  164.     Caution: the program may crash on corrupted input.
  165.  
  166. FOUND A BUG?
  167.  
  168.     Send bugs reports and fixes to the author. For bugs, please include
  169.     as much information as to their location as possible, since I may not
  170.     have the resources to duplicate the them.
  171.  
  172.     David Albert Bagley,    bagleyd@hertz.njit.edu
  173.  
  174. HISTORY
  175.  
  176.   [Apr 08, 96]    V5.3: Minor changes.
  177.   [Jan 31, 96]    V5.2: Puzzle can be moved by a more intuitive drag and
  178.         drop approach.  Sectors will invert, when selected.
  179.         Now using dynamic allocation, so there is no maximum
  180.         number of rings.  The maximum number of wedges though
  181.         is still fixed at 8.
  182.   [Dec 15, 95]    V5.1: Minor updates, RNG for 32/64 bit. Better sector
  183.         drawing algorithm.  I did not figure out the border
  184.         lines on the sectors, next time...
  185.   [Oct 02, 95]    V5.0: Xt/Motif, your choice.
  186.   [May 16, 95]    V4.10: Warnings removed from Sun's cc and lint and now
  187.                 include a random number generator.
  188.   [Mar 13, 95]    V1.4: Removed lint warnings and added a VMS make.com .
  189.   [Nov 11, 94]    V1.3: Conservative guess for random number generator.
  190.   [Nov 07, 94]    V1.2: Now allows undos, saves, and recalls.
  191.   [Sep 19, 94]    V1.1: Minor changes.
  192.   [Sep 15, 94]    V1.0: Xt version.
  193.